═══ 1. DiskJockey Overview ═══ The DiskJockey is Clear & Simple's answer to file management for OS/2, it helps you easily navigate through the maze of drives and directories and play your disks. While OS/2's object oriented folder/icon approach to file management is great for many operations, it often leaves much to be desired in terms of navigating speed and simplicity. DiskJockey is designed to be quick and easy to use. It offers multithreaded facilities for file operations such as delete, copy, move, view and rename. It also includes unique facilities for quickly playing multimedia files including a built-in JukeBox for queueing up both audio and midi files. The DJ really shines when used for ZIP and UNZIP operations. Using Info-Zip's archiving (zipping) utilities and the DJ Zip Container - just drag and drop files onto the zipper to add them to an existing archive. Viewing a zipped file is also a snap, just double-click and you get a view of what's inside - further clicking on the file list lets you view, play and extract individual files in the zipped file without unzipping! You can also easily change file attributes, quick format diskettes with a single click and create directories. Additional features include: Drive Clean-Up to remove unwanted duplicate files, file search and file cataloging. All functions are easily accessible in the convenient and straight forward Control Panel by mouse and/or keyboard hot keys. The DiskJockey Control Panel: Important Note! This help book assumes that you have basic knowledge of the workings of OS/2 (Like how to use a keyboard and mouse). Be sure to remember that your mouse has two buttons! OS/2 uses the right mouse button (aka mouse button two) extensively as does the DJ. Take the time to learn the workings of the second mouse button and you will find the DJ (and OS/2) to be more powerful, flexible and useful. ═══ 2. Navigating with the DiskJockey ═══ The DiskJockey uses a model of file navigating based on text-lists, whereas the OS/2 WorkPlace Shell uses an icon-object model. DJ adopted this method because on most systems the text-list model is faster when locating and displaying directories, filenames and statistics. In addition, many people find the text-list model easier to use. Copy and move operations are simply performed by selecting the directory or file(s) to be copied, then pressing the copy or move button. A "Where-to" list will appear prompting you to choose the "TO" directory. Popup menus and shortcut keys augment the buttons for added convenience, depending on where the mouse pointer is located, or when your hands are on the keyboard. We recognize that the WPS model also has its advantages, especially when performing drag and drop operations. For this reason, the DJ was designed to work with the WPS, supporting both list-based copy/move/delete and drag and drop copy/move/delete. OPEN a WPS FOLDER The DJ provides a function for opening WPS drive and directory folders with a simple double-click on the list item within the DJ. Double-click on the C: drive in its list of drives - and the drive folder will open. Similarly, a double-click on a directory name will open a WPS directory folder. DRAG and DROP Within the DJ files may be dragged and dropped onto the Jukebox or Zip container. Also, files may be dragged from the Search and/or the Catalog windows to the Clear & Simple Logo on the main screen to copy or move files to the "current" directory. Files can not be dropped onto the directory list or drives list (but you can open a drive or directory folder and drag and drop to it). When dragging to the DJ (from the WPS) you may drop onto the Clear & Simple Logo to move/copy to the "current directory" - that directory is the name immediately below the logo. You may also drag multimedia files from a folder dropping them onto the Jukebox, likewise directories and/or files may be dragged from a folder and dropped onto the Zip container. When dragging from the DJ you may drag file(s) to a WPS drive or directory folder or to another active copy of the DJ! When you first start DiskJockey it will open highlighting the drive and directory which was selected the last time you used it. Likewise when switching drives, the directory last selected on that drive will be highlighted. For help with selecting drives, directories or files click on one of the topics below: Selecting Drives Selecting Directories Selecting Files ═══ 2.1. Selecting Drives ═══ Changing Current Drive To switch drives simply single click on the drive letter in the drive bar along the left side of the window: Or select from the pull down drive list on top: You can also tab to the window and select the drive from the keyboard. Select a diskette drive (A: or B:) to display the free space on the diskette currently in that diskette drive (displayed in the status line). Double-click on a drive letter to open a WPS default view of that drive. ═══ 2.2. Selecting Directories ═══ Changing Current Directory To view files in a new directory just single click on the directory name in the Directory tree window: Clicking on a directory with subdirectories will show the directory expansion symbol. Click on it to show the subdirectories below. Double-click on a directory name to open a WPS default view of that directory (folder). ═══ 2.3. Selecting Files ═══ Selecting files In order to perform a file operation you must first select a file or group of files. First, select the directory you wish to choose from. To Select a single file, position the mouse pointer over the file (in the file window), and click on mouse button 1. To select multiple files, hold mouse button 1 down over the first file and swipe across the files you want. You can also select or deselect individual files by holding the key and clicking on the file with mouse button 1. File Window Double-clicking on a file or list of files will invoke the DJ's viewer, giving you a quick view of the contents of the file(s). Once files are selected all file operations are easily performed - just press a button! After files are selected they may also be dragged and dropped to the Jukebox/Zip container or to WPS folders. Selecting a file that has an HPFS longname in its extended attributes will display that file's longname in the status line. For other selection options see Marking and UnMarking Files. ═══ 2.4. Searching for files ═══ Searching For Files Use the search function to quickly locate, view and catalog files. Press the button on the Control Panel and you will be presented with a search dialog box: First you must define the parameters of your search: o First, select the drives to be searched. o Then add a file specification (filespec). Use wildcards (*,?). o To further narrow your search use these optional search parameters: - Text String - Useful for finding a specific text item inside a file. - Creation Date - Tell the search to include files created before and/or after a certain date. - Size - Include files larger than a given size, in multiples of 1000. - Exclude files with the following extensions. The standard three character file extension should be entered - there is no need for the period - multiple extensions should be separated by semicolons. e.g. exe;dll;sys;inf Select the drives, specify path, filespec and/or text string to search for and press the button. Results of the search are placed in the results window. Launch programs or view files from the window by double clicking on the file's name. The button will halt the search. The button will reset the form for a new search. To Catalog files press the button. -See File Catalogs for further instructions. Check the "Reduce Priority" box to limit a search's use of the CPU. Useful for searching large volumes while multitasking. This option will slow down the search time. The buttons View, Delete, Copy, Move and Edit are the same as their counterparts on the main panel. See their explanations for instructions. Press to close the search session. Also See: Search Panel Elements ═══ 2.5. File Catalogs ═══ Catalog DJ's catalog facility gives you an easy way to group files with common characteristics. For example, you might want a catalog of all of the .MID files across all of the drives in your system. Using the catalog panel you can quickly access this entire group. Cataloging files To catalog files, first perform a search based on how you would like to organize the files. After the search is completed press the button. This will bring up the catalog window: Fill in a catalog description, if desired. Give the catalog a name and press the button to create the catalog. If the DJ is installed on an HPFS drive you can give the catalogs long, descriptive names. On FAT drives you are restricted to the 8.3 naming convention View catalogued items by selecting files to be viewed and pressing the button or by double clicking on them. See Viewing Files for more information. Other Panel Elements: o Size - Shows total size of selected files. o Time Stamp/Total selected - Shows date of file's creation if only one file is selected. If multiple files are selected, shows # selected. o Button Bar - Buttons used to perform actions in Catalog contents window. See Search function help for more details. Catalog Maintenance You can perform several of the DJ's file operations and search or delete catalogs from within the Catalog Maintenance window. First open the "Catalog Maintenance and Viewing" window by pressing the button. Select a catalog to view from the catalog list. Use the buttons along the bottom of the window to: o Update. Press the button to refresh catalog based on original search parameters. o The buttons View, Delete, Copy, Move and Edit are the same as their counterparts on the main panel. See their explanations for instructions. o Find files in selected catalogs by pressing the button. This brings up a dialog box. o To remove catalogs from the list, select the catalogs you would like to delete and press the button. o Press to return to the main DJ window. o Drag file(s) directly from the file list to the DJ main window: Drop onto the Clear & simple logo will perform a copy/move operation to the current directory. Drop onto the DJ logo to play in the Jukebox. Drop onto the Zip container to add the file to an existing zip file. Drop onto a WPS folder to move/copy to that folder. Also See: Catalog Panel Elements ═══ 3. Performing file operations ═══ DiskJockey performs standard file operations on single or multiple selected files. Click on the operation below to view detailed instructions. o Copy o Delete o Move o Rename o Zip o UnZip o Change File Attributes o View o Mark and UnMark ═══ 3.1. Copy ═══ Copying Files To copy file(s) first, select the files you wish to copy. Then click the button. Or, click the right mouse button in the file window to bring up the pop-up menu: Choose Copy. Or, Use the keyboard shortcut You will be presented with a Where To? copy dialog: from which you can select a destination for the copy operation. Press the button to start Copying. For situations where you are copying HPFS "long named" files to FAT volumes, the DJ may automatically rename the files. This can cause conflicts. See the section in this helpfile called "Special note on HPFS to FAT operations" for more details. ═══ 3.2. Delete ═══ Deleting Files To delete file(s) first, select the files you wish to delete. Then click the button. Or, click the right mouse button in the file window to bring up the pop-up menu: Or, Use the keyboard shortcut or the Delete button on your keyboard. If you do not have "Confirm?" checked, the selected files will be deleted without warning. Press the button to start Deleting. Deleting Directories The DJ lets you delete entire directory structures. This includes all of the subdirectories within a directory and all of the files in the directory and its subdirectories. First, select the directory you wish to delete. Then click on the delete button. or use the popup menu, or keyboard shortcut keys, like deleting a file. Directory deleting will always be "confirmed" even if you have Confirmation checked "No". Delete Method This preference option is difficult to explain. The two choices use different OS/2 mechanisms for deleting directories. Destroy uses the OS/2 DestroyObject facility. This is the faster method of deleting an entire directory structure. However, it will not delete files that have special WPS non-deleteable attributes set. When encountering those hard-to-delete directories, choose the DJdelete option. This option causes a more deliberate method of deletion. Starting at the end of the directory structure each file's attributes are changed to assure deletion, likewise the directory attributes are reset before deletion. This will take longer, but it does get the job done! ═══ 3.3. Move ═══ Moving Files To move file(s) first, select the files you wish to move. Then click the button. Or, click the right mouse button in the file window to bring up the pop-up menu: You will be presented with a "Where To?" move dialog, from which you can select a destination for the move operation. Press the button to start Moving. For situations where you are moving HPFS "long named" files to FAT volumes, the DJ may automatically rename the files. This can cause conflicts. See the section in this helpfile called "Special note on HPFS to FAT operations" for more details. ═══ 3.4. Rename ═══ Renaming Files To rename a file, first select the file you wish to rename. Then click the button. Or, use the keyboard shortcut This will activate the entry field below the file window. Enter the file's new name here: Then press the button or to complete the operation. ═══ 3.5. Zipping ═══ Zipping Files What is Zipping? The Zip function is an excellent way to compress files. File compression takes a file or group of files and reduces them into a single file, often called a zipfile. This is useful for archiving or backing up files, fitting large or numerous files on a diskette, or reducing the online time necessary to send files over the internet. Use UnZip to decompress Zipped files. How To Zip To Zip file(s) or a directory, first select the files or directory you wish to Zip. Then, click the button. Or, click the right mouse button in the file window to bring up the pop-up menu: Select "Zip" from the menu. Or, Use the keyboard shortcut If you have a directory selected, the entire directory will be compressed into a file named "directory.zip" If you have selected a file or a group of files they will be compressed into a file with the name of the first file of the group but with the extension ".zip" ( i.e. "firstfile.zip" ). You will be presented with a "Where To?" Zip dialog, from which you can select a destination for the new Zip file. You may also change the name of this file in the "Where To?" box. You do not have to name it with the .zip extension, however the .zip will make it easier to identify as a zipfile. Press the button to start Zipping. Easiest Zipping see : ZIP Container Advanced Options The DJ has made some of Zip's advanced options available. We wanted to keep it fairly simple. Click on the "Advanced Options" button to open: -j junk (don't record) directory names Default - checked when zipping a list of files, unchecked when zipping a directory. Checking this item, removes the directory name in the resulting zipped file. By unchecking this box, the directory name is recorded along with the filenames, later, when you unzip the zipped file you may choose to have the directory structure created at the unzip location. -m move into zipfile (delete files) This advanced option essentially zips the selected file(s) and then deletes them. This is useful for those times you want to free some disk space, but you're not sure you want to entirely discard a directory or group of files. The default is unchecked. -S include system and hidden files This advanced option allows you to include those files normally not seen by the casual user - those files with the system and/or hidden attribute set. Since the DJ optionally shows these system and hidden files, we included this as an advanced option. The default is unchecked, so you must check this item to have files with system or hidden attributes included in the resulting zipped file - the DJ does not assume inclusion when this option is left unchecked, even if the file is selected - also, there is no warning. -f freshen: only add changed files This advanced option is for the times when you want to update those large zipped files with a few changed ones. -u update: only changed or new files Similar to the above, also includes new files. -q quiet operation The default, doesn't provide any feedback. The DJ will notify you if there are error conditions. If there are, we recommend that you re-run the zip operation with this turned off - so that additional error information can be provided. (see the -v option below) -v verbose operation This is how to turn quiet operation off. Checking this option turns on the DJ's Standard I/O window, to show the OS/2 messages we normally spare the user from. It also informs the zip operation to give details of its zipping. -T Test zipfile before deleting source This should be used with the move into zipped file option explained above. Always a good idea to use with that option. Default unchecked, but it is automatically checked when the -m move into zipped option is checked.. -r include all sub-directories The default is checked when zipping a directory - unchecked when zipping a list of files. Uncheck , when zipping a directory and you don't want the sub-directory structure included in the resulting zipped file. Compression Level Higher number chosen will attempt to produce a greater compression - will increase the time needed to zip. Also See: Zip Container About Zip and UnZip ═══ 3.6. Zip Container ═══ Zip Container Drag and drop files into the zip container and they will be automatically compressed into a zip archive! This allows for easily grouping files into an archive. To add files to an existing zip archive: 1. Position the mouse pointer over any .zip file and single click on it. This will change the Clear & Simple logo, in the upper right corner of the DJ panel, into the Zip Container. 2. Now you can select files to archive and simply drag and drop them into the Zip Container! 3. Repeat step 2 for files in other directories or drives. 4. When finished zipping just double click on the Zip Container to close it, the DJ logo will reappear. ═══ 3.7. UnZipping ═══ Unzipping Files How to UnZip Use Unzip to extract compressed files from a zipfile. To UnZip a file, first select the file you wish to UnZip. Then click the button. Or, click the right mouse button in the file window to bring up the pop-up menu: Or, Use the keyboard shortcut You will be presented with a "Where To?" UnZip dialog, from which you can select a directory for the files to be unzipped into. Press the button to start Unzipping. Extracting a single file You can extract a single file from a zipfile by selecting and double-clicking on that file. This will use the DJ view facility to show you the contents of the zipped file in list form. Select the file you want to extract and then press the Extract button. the file will be extracted (unzipped) to the current directory. Advanced Options The DJ has made some of the unzip advanced options available. There are two options and four modifiers to be used with the options. Press the "Advanced Options" button to open: -f freshen existing files, create none When unzipping a file, the extracted files will only update those that already exist in the to location. Default is unchecked which will update and create new files. -u update files, create if necessary When unzipping a file the extracted files will update existing files, and create new files. This is the DJ's default. -n never overwrite existing files When unzipping a zipped file, the resulting files may not overwrite a file in the to location (if that file exists). Default is unchecked. -qq suppress msgs -v display msgs The default, -qq, doesn't provide any feedback. The DJ will notify you if there are error conditions. If there are, we recommend that you re-run the unzip operation with the -v display msgs turned on - so that additional error information can be provided. -j do NOT recreate paths An option for those files previously zipped with the option to keep the directory information. Checking this option tells the DJ to ignore that directory information and not create the directory structure. The default of unchecked will create directory paths if present in the zipped file. ═══ 3.8. Changing file attributes ═══ Changing File Attributes DiskJockey allows you to easily change a file's or multiple files' attributes. To change a file's attributes: first, select the file(s) you wish to modify. Then click the button. This will present the change attributes dialog: For each attribute you will have three choices: o Make no change. o Turn attribute off o Set attribute on Once you have made your selections press the button to make the changes. ═══ 3.9. View ═══ Viewing Files DiskJockey handles several file types with a quick internal viewing facility. For unrecognized filetypes the selected file will open in it's default view or application. To view a file: o Select the file(s) to view. o For single files just double click on the file name. o For multiple files press the button. Internally supported filetypes DiskJockey has internal support for the following filetypes: o Graphics files: .bmp, .gif, .tif, .jpg These filetypes are quickly viewed with the DJ's internal view window. o Sound files: .wav, .mid, .au Sounds are cued for sequential play in the DJ's Jukebox. Use the controls much like you would those on a CD player: Skips forward or back through cued sounds. Temporarily pauses play. Restarts play. Stops play. o Plaintext files Textfiles are presented in a searchable window for quick access. o Zipfiles Double click on a zipfile to display its contents: Click on a file in this view window to view or execute directly from the zip archive! Select a file and press the Extract button to have that single file extracted (unzipped) from the zipped file. If you do not like the DJ's viewers you can select your own. See Configuring Viewers and Editors for details. ═══ 3.10. Jukebox ═══ The Jukebox Select multiple or individual audio/video files and drag and drop them onto the Jukebox window (this is the DJ logo). The files will be sequentially cued and play will begin automatically. Sounds and video files are played in a background thread so that you can perform other operations at the same time. An alternate way to play is by double-clicking on a file or group of files, or selecting a group of files and pressing the play button or even the view button. Use the player controls to skip forward or back, pause, stop or resume play. ═══ 3.11. Marking and Unmarking Files ═══ Marking and Unmarking Files DiskJockey has several options for marking files. -Press the button -Or, Use the keyboard shortcut A dialog box appears: Select the options for the files you wish to mark. o All files will mark all the files in the file window. o No files will unmark any selected files in the file window. o Reverse marking will mark unselected files and unmark previously selected files (right click on the UNMARK button will also reverse mark). o If you choose Filespec..., enter a file specification you wish to mark (or unmark). o The text option will search for a given text string anywhere in the filename. After choosing the desired action, press the button. To quickly select all files use the keyboard shortcut Files can also be selected or deslected directly. See Selecting Files for more information. ═══ 3.12. Sorting files ═══ Sorting Files Three ways to sort the current file list: 1. -Click on the button. -A dialog box will appear: -Choose your sort criteria: filename, extension, size or date/time. -Select ordering of sort: ascending or descending -Set when you want the sort to occur: one-time, Sort this run (this session), permanent (all DJ sessions), No Sorting (suspend sorting now and in following DJ sessions). -Press the button or to begin. 2. -Right click in the file window to expose the pop-up menu. -Select desired sort options: 3. Use the keyboard shortcuts: - Sort by name, descending - Sort by name, ascending - Sort by extension, ascending (all are one-time sorts) ═══ 3.13. Quick Format ═══ This action will quickly format a diskette. To format a diskette: o Insert the diskette to be formatted into the drive. o Use the right mouse button to toggle between drive A: and drive B: (if present.) o Click the button to format the diskette. o If you have the Confirmation option set "On" a window will pop up to warn you that all information on the diskette will be lost, etc. Keyboard Operation o You can also use the keyboard shortcuts: Formats drive A: Formats drive B: ═══ 3.14. Making Directories ═══ To create a new directory: 1. Select the directory where you want the new directory to be created. 2. -Click on the button. -Or, use the keyboard shortcut 3. Enter the new directory name in the entry field: This DJ can create several levels of directories at the same time. Just enter the directories as a path and they will be automatically created. i.e.: L:\parent\new1\new2\new3\newetc 4. Click on the button. ═══ 4. Preferences ═══ Preference Menu The Preference pull-down menu allows you to tailor the DJ's fonts and actions to your tastes. Clicking "Preferences" on the menu bar presents the menu: The viewing item lets you select between the DJ's internal viewer or an objects system default viewer. Clicking the Set Font option gives you a list of font types and sizes to choose from: Click on default to return the DJ's fonts to their original state. This pull-down menu will change the font for all windows. To change the font for individual windows click the right mouse button in the window you wish to change and use the font option of the pop-up menu. You can also change fonts by using the Keyboard hot keys: o Resets to default font. o Sets font size 2 through 10 o Sets font size 11 through 18 Auto Dir Expand allows you to toggle the automatic expansion of subdirectory trees when the parent directory is selected. The default is On. Beep lets you turn off the beep sound when an operation completes. Defaults to On. Auto Dir Return toggles on/off the feature that returns you to the working directory when a file operation completes. The default setting is On. Confirmation toggles the confirm option on/off. With this option on a confirmation message will occur when deleting files or formatting a diskette. The Editor option presents a dialog box which allows you to specify the default editors and viewers used by the DJ. See Configuring Viewers and Editors for more information. Colors allows you to save a custom color configuration or reset the colors to their default. To change the DJ's colors, use the system's color palette to drag and drop the color on the area of the DJ you would like to change. Hold down the key to change the foreground (text) color. Show Hidden Files When checked off this option screens out hidden, system and read-only files from the file window. These are usually key system files which should not be eliminated or moved. If you are unsure about this option it is probably best to leave it set to "off." Delete Method For most file and directory deletions the standard destroy method will do the job. For files with the un-deleteable extended attribute a different method "DJ Delete" will reset the un-deleteable EA and delete the file. This can be time consuming during normal operation, so we made it an option. If you are having difficulty deleting certain files, give the DJ Delete option a try - but be careful - undeleteable files are often that way for good reason. ═══ 5. About Info-Zip ═══ The DiskJockey uses Info-ZIP's compression utilities for it's Zip and UnZip functions. Info-ZIP is a widely used and distributed FREEWARE package. No charge has been added to the DiskJockey's price for the distribution of this freeware package. It is included as a convenience for users of the DiskJockey. The latest versions of Zip and UnZip (at the time of this publication) are included with the DiskJockey. For more information see the official accompanying documentation. Info-ZIP's software (Zip, UnZip and related utilities) is free and can be obtained as source code or executables from various anonymous-ftp sites, including ftp.uu.net:/pub/archiving/zip/*. ═══ 6. Hot Keys ═══ Keyboard Shortcuts The DiskJockey makes extensive use of keyboard shortcuts, often called Hot Keys. Below are the hot keys and a brief description of their functions. Help. Opens context sensitive help dialog. Copy Delete Zip UnZip Format A: Format B: Turn Beep Option on Turn Beep Option off Turn Confirmation option on Turn Confirmation option off Sort by name, descending Edit Reset to default font sizes Filter Mark all Opens Mark dialog Make new directory Open default file view Rename Sort by name, ascending Sort by extension, ascending Set font sizes 2 through 10 Set font sizes 11 through 18 ═══ 7. Editing Files ═══ Editing Files To edit a text file: 1. Select the file(s) you would like to edit. 2. Press the button or, choose the edit option from the Right Mouse Button pop-up menu: 3. Your editor of choice will open with the selected file loaded. See the Configuring Viewers and Editors section for information on selecting an editor. ═══ 8. Main Panel Controls Description ═══ Main Panel Double Click anywhere on the panel below for more info about that feature. ═══ 8.1. Drop Box ═══ The Clear & Simple logo in the upper left corner of the main window is used to receive a drag and drop action. i.e.: Dragging an object from an open folder to the Drop Box will copy/move that object to the DJ's current directory. ═══ 8.2. Current Dir Window ═══ Shows fully qualified pathname of currently selected directory. Also see: Selecting Directories ═══ 8.3. Sub button ═══ Press to include all subdirectories below current directory in calculation of space used. Warning: this could take a long time to calculate on a large directory structure. It is done in a background thread - but changing the DJ's current directory will cause the results to be lost. ═══ 8.4. Total Space Window ═══ Shows total space used by all files in active directory. Includes all files in all subdirectories in calculation when button is pressed. ═══ 8.5. Number of files window ═══ This shows the number of files contained in the current directory. ═══ 8.6. Date & Time ═══ Today's date and time of day. ═══ 8.7. Jukebox/Zip container window ═══ This field is used for two purposes. Drag files to this window to cue for jukebox or add to active zipfile. Shows DJ logo when Jukebox; zipper logo when Zip Container. Also See: Jukebox Zip Container ═══ 8.8. Jukebox/Zip container Name window ═══ Shows name of sound being played by Jukebox or active zipfile in Zip Container. ═══ 8.9. Jukebox Controls ═══ Buttons used for controlling play of sound files. Also See: Jukebox ═══ 8.10. Jukebox Volume ═══ Adjusts volume of Jukebox's currently playing sound. Also See: Jukebox ═══ 8.11. Drive Pulldown Menu ═══ Shows detailed info on all drives. Includes Drive Letter, File System Type, Total Drive Space, Free Space, Percentage of Total space currently available and Drive Label. Select a drive from the list to make it the current drive. Also See: Selecting Drives ═══ 8.12. Selected files Space ═══ Shows total drive space used by currently selected files. ═══ 8.13. Number of selected files window ═══ Shows number of files currently selected in file window. ═══ 8.14. FIlter Window ═══ Displays user defined filter for files displayed in File window. Also See: File Filters ═══ 8.15. File Window ═══ Shows files in selected directory according to specified file filter. Also See: Selecting Files ═══ 8.16. File Details Window ═══ Presents detailed information about each file. Includes file's Size, Date and Time of creation, and Attributes. Also See: Selecting Files Changing file Attributes ═══ 8.17. File Operation Count ═══ Shows number of files remaining for current Copy, Move or Delete operation. ═══ 8.18. Status Line ═══ The status line has several uses: - It presents error and status messages pertaining to current file operation. - Enter name during rename operation or file filter specs. - Displays HPFS longnames when a selected file has a longname in its extended attributes. - Free space on a diskette is placed in the status line when a diskette drive is selected and there is a diskette present. ═══ 8.19. Clean-Up button ═══ Press Clean-Up to find and review Duplicate files in system. Also See: Drive Clean-Up ═══ 8.20. Information Line ═══ Shows information about the field that the mouse pointer is positioned over. ═══ 8.21. Drive Window ═══ Shows all drives available in system. Active Drive is highlighted. Also See: Selecting Drives ═══ 9. Search Panel Elements ═══ Search Panel Elements Click an area of the search panel to view detailed information about each element: ═══ 9.1. Filespec ═══ Enter a filename search string. Wildcard characters (*,?) may be used. i.e. To find all files with the extensions ".htm" and ".html" enter "*.htm*". This is a required field for the search operation. ═══ 9.2. Exclude Files ═══ Enter file extensions to exclude from the search. i.e. If your search filespec is *.* but you would like to exclude all files with the extensions ".txt" and ".zip" then enter "txt;zip" here. (Extensions should be separated with semicolons.) ═══ 9.3. Text String ═══ Enter a text string to search for within the files matching the given filespec. ═══ 9.4. Creation Date ═══ Enter dates to exclude from search. Use the format mm/dd/yy. ═══ 9.5. Size Field ═══ Use the size field to specify a lower size limit for a search in multiples of 1000. i.e. To find all files larger than 10,000 bytes, enter 10. ═══ 9.6. Search Results Window ═══ Shows fully qualified path and name of all files matching specified search criteria. Use this window to select files for file operations View, Delete, Copy, Move or Edit. ═══ 9.7. Button Bar ═══ Buttons used to perform actions in "Results Window". See Search function help for more details. ═══ 10. Catalog Panel Elements ═══ Catalog DJ's catalog facility gives you an easy way to group files with common attributes. For example, you might want a catalog of all of the .BMP files across all of the drives in your system. Using the catalog panel you can quickly access this entire group. Catalog Panel Elements o Catalog Name - Enter a name for this catalog here. o Catalog Description - Enter a description for the current catalog. o Catalog Contents Window - Similar to the Search Results Window. Shows fully qualified path and name of all files in catalog. o Size - Shows total size of selected files. o Time Stamp/Total selected - Shows date of file's creation if only one file is selected. If multiple files are selected, shows # selected. o Button Bar - Buttons used to perform actions in Catalog contents window. See Search function help for more details. o Drag file(s) directly from the file list to the DJ main window: Drop onto the Clear & simple logo will perform a copy/move operation to the current directory. Drop onto the DJ logo to play in the Jukebox. Drop onto the Zip container to add the file to an existing zip file. Drop onto a WPS folder to move/copy to that folder. ═══ 11. Clean-Up Window ═══ Clean-Up Window o Duplicate Search Parameters - These are similar to the fields found in the "Search Window" o Filespec include - Filespec of files to be included in the duplicate search. o Filespec exclude - Filespec of files to be excluded from the duplicate search. o Date exclusion - Excludes files before and after specified date from search o Size exclusion - Excludes files based on size. Set 3-State checkbox to exclude files larger than or less than a given filesize (in multiples of 1000 bytes) or set for "No size limits" to include files of any size. o Result Window - Shows duplicate files found. o Button Bar - Buttons used to perform actions in "Results Window". Also See: View Delete Copy Move Edit ═══ 12. Where To? Window Elements ═══ Where To? Window Elements o Path Field - Shows currently selected path. Can be directly edited to create a new directory. o Drive Window - Shows all drive available in system. Active Drive is highlighted. o Directory Tree Window - Shows currently selected drive's directory structure. o Create New Directory - Check this box to allow the DiskJockey to create a directory entered in the "Path Field" ═══ 13. Drive Clean-Up ═══ Drive Clean-Up After using your system for a while you may start running out of drive space. Oftentimes you can free up space by eliminating files that are duplicated in multiple directories on your system. Use the Drive Clean-Up function to search your drives and find redundant files. It's a great way to eliminate files that might be wasting valuable drive space! To perform a drive Clean-Up start by pressing the button. This will open the Clean-Up window: Enter your search parameters. These are similar to the fields in the "Search Window" Press the button. The DJ will perform the search and report back the results. Here's some duplicates on my "C" drive: Duplicates are listed together and separated from others by a blank space. Most likely you will want to move or delete the duplicates. CAUTION: As you can see in the example above, some files are duplicated in the system archives. These files are used to recreate your desktop if it becomes corrupted. They are valuable backups which should not be removed. Be careful when removing duplicates! From this window you may also perform the following file operations: Launch programs or view files from the window by double clicking on the file's name. To Catalog files press the button. -See File Catalogs for further instructions. The buttons View, Delete, Copy, Move and Edit are the same as their counterparts on the main panel. See their explanations for instructions. Drag file(s) directly from the file list to the DJ main window: Drop onto the Clear & simple logo will perform a copy/move operation to the current directory. Drop onto the DJ logo to play in the Jukebox. Drop onto the Zip container to add the file to an existing zip file. Drop onto a WPS folder to move/copy to that folder. The button will halt the search. The button will reset the search form for a new search. Press to close the Clean-Up session. ═══ 14. Special note on HPFS to FAT operations ═══ The DJ gives you the option to control copying files to/from HPFS volumes to/from FAT volumes. As you know, HPFS supports filenames up to 255 characters long - the name may even contain spaces! Whereas FAT only supports the 8.3 character filenaming convention. HPFS longnames OS/2 provides a facility within its extended attributes to retain the long filename when copying to FAT volumes. Many file managers don't take advantage of this facility - even the OS/2 copy command misses this feature. The DJ gives you the option to turn this On or Off. This option is found in the preferences menu. The setting is retained for subsequent DJ sessions. Why turn it Off? Speed is the answer, especially when copying to diskette. Leaving it On, provides you the advantage of having the longname associated with a FAT file so that when it is copied it back to an HPFS volume - the longname is used. Also when selecting filenames on a FAT volume - the longname (if present) will display in the status area. HPFS longnames Off In situations where a "long named" HPFS file is copied or moved to a FAT volume, up to the first 8 characters before the first period, and the first three characters after the last period are used to rename the file. Spaces are changed to underscores. i.e.: "averylong.file.name" would become "averylon.nam". "this.file.name" would become "this.nam" "name with.spaces.in it" becomes "name_wit.in_" This works very well for most copy operations. However, in the interest of maintaining the efficiency of copy and move operations we found it necessary to make a concession concerning this renaming. A problem occurs using this algorithm: if you have files where the first eight characters before the first period and the first three after the last period are the same but the middle characters are different, a conflict may occur. If they are copied at the same time, they will overwrite one another. This is best illustrated by an example: If "longname.file1.problem" becomes "longname.pro" and: "longname.file2.problem" becomes "longname.pro" As you can see, both files are given the same name. This is not a problem if they are copied one at a time, because the DJ will prompt you to rename or copy over them. But if you batch copy them the DJ will not catch this anomaly and will copy the second file over the first. Therefore, do not batch copy files which use this naming convention for it will cause them to overwrite each other. We found that further error checking at this level significantly slowed down all copy operations. In order to optimize performance under most situations, we decided to let this be. ═══ 15. Configuring Viewers and Editors ═══ Configuring Viewers The DiskJockey is capable of natively viewing many standard filetypes. You may, however, find situations where you prefer to use your own viewer for this purpose. The DJ can be easily configured to use third party viewers. To do so, choose the editors/viewers option from the Preferences pull down menu. This will open the editor configuration window. Enter the filetype extension in the field on the left. Then specify the viewer's fully qualified pathname in the viewer field. Either directly enter it or locate it with the DJ and drag and drop the viewer from the DJ's control panel to the entry field. Press the add button to add the filetype and viewer to the list of associations. Add as many viewers as you would like. When you are finished press the save button to save your entries and exit the configuration window. To remove a viewer configuration: Open the editors/viewers configuration menu, select the viewer you would like removed and press the delete button. To change viewer configurations: Open the viewer configuration menu, select the viewer you would like to change and press the edit button. This will place the extension and viewer name in the entry fields where they can be easily changed as above. Placing * in the extension field will cause the corresponding viewer to become the viewer for all files, (if you have more than one viewer you want the DJ to use, place the * at the end of the list). Configuring Editors Specify the text editor to be opened when the Edit action is selected. The DJ is set up initially to open OS/2's system editor. Choose the Preferences-->Editors/Viewers from the pull down menu to change the default editor. You are given three choices: System Editor, Enhanced Editor or User editor. To specify a third party editor select "User Editor" and enter the editor's path and name. ═══ 16. File Filters ═══ Limit the display of files in the "File Window" to those matching a specific name format by entering a File Filter. By default this is set to "*.*" which includes all files. To change the file filter press the button. This will activate the filter entry field: Enter a filter in the field and press the "Set Filter" button. The wildcard characters "*" and "?" can be used. i.e. To only show files with the extension "txt" enter "*.txt" in the filter field. Toggle back to the default "*.*" setting by right clicking on the button. ═══ 17. Refresh Button ═══ Use the button directly above the Drive Window to refresh the drive, directory and file windows. This is particularly useful when changes have been made in the workplace shell which the DiskJockey is not aware